home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 23.zip / BS1 part 23 / Bootstart.adf / IFFX / IFFX1.62.doc < prev    next >
Text File  |  1991-04-09  |  8KB  |  231 lines
  1.  
  2.                       IFFX 1.62 User Manual
  3.  
  4.                           March 5, 1991
  5.  
  6.                     Requires the arp.library
  7.            KickStart 2.0 and Workbench 2.0 compatible
  8.  
  9.  
  10. DISCLAIMER
  11.  
  12. IFFX has been thoroughly tested and is the result of a constant
  13. process of changes and updates.  The program has proven to be
  14. stable in everyday use.  The author is not responsible for any
  15. loss of data, damages to software or hardware that may result
  16. directly or indirectly from the use of this program.
  17.  
  18. If you have suggestions or remarks about this program, of if you
  19. find any bugs, please let me know.
  20.  
  21. Write to the following address:
  22.  
  23.         Peter Stuer
  24.         Kauwlei 21
  25.         B-2550 Kontich
  26.         Belgium - Europe
  27.  
  28.  
  29. NOTE
  30.  
  31. This program needs the arp.library to run.  Make sure it is in
  32. the LIBS drawer of your boot-disk.  IFFX will not run without it
  33. and will exit quietly.
  34.  
  35.  
  36. This documentation will always be updated at the top.  Users of
  37. previous versions of IFFX need only read the paragraph reflecting
  38. the changes since their last version.
  39.  
  40.  
  41. Changes from v1.61
  42. ------------------
  43.  
  44. - Fixed a bug I discovered when viewing some IBM .lbm files:
  45.   When IFFX encountered an unknown compression scheme it would be
  46.   handled OK except that the window and the screen stayed open.
  47.  
  48. Changes from v1.60
  49. ------------------
  50.  
  51. - Fixed an 'error' in the error routine (pun intended)
  52.  
  53.  
  54. Changes from v1.52
  55. ------------------
  56.  
  57. - Instead of moving the whole view only the viewport of the IFFX
  58.   screen is moved when displaying overscan pictures or NTSC
  59.   pictures on a PAL system.  This allows you the switch the IFFX
  60.   screen to the front and back without finding your Workbench
  61.   screen shifted to the other side of The Twilight Zone.
  62.  
  63. - The standard screen height is now looked up in GfxBase.
  64.  
  65. - If no arguments are passed the ARP filerequester pops up.  It
  66.   keeps popping up until you select Cancel.
  67.  
  68. - Ctrl-C can now be used to stop IFFX when it is showing a whole
  69.   bunch of pictures, either enumerated or using a wild-card.
  70.   IFFX will stop after the current picture has been shown.
  71.  
  72. - IFFX can now be started from the Workbench.  You can put IFFX
  73.   in the Default Tool field of a project or use the standard
  74.   Workbench shift-select method to give IFFX its arguments.
  75.  
  76.  
  77. Introduction
  78. ------------
  79.  
  80.     I know, there are a zillion of IFF ILBM picture showers.  So
  81. why write another one ?  Well, most of them are written in C.
  82. This means relatively large and slow code.  The ones written in
  83. Assembler either had too few features or didn't handle PAL/NTSC
  84. or overscan pictures.
  85.     I wanted this program to be a lean, mean picture showing
  86. machine.  IFFX is written completely written in highly optimized
  87. Assembler.  This accounts for the small executable size.  It
  88. handles PAL/NTSC, interlace, HAM, EHB, oversized, compressed or
  89. uncompressed pictures.  It shows the first picture of an IFF ANIM
  90. file and the first brush of an ANIM brush.  The information found
  91. in ANNO and AUTH chunks is typed to the CLI window.  It can be
  92. made resident (either with the Workbench 1.3, the ARP or the
  93. CShell resident command) and it is fully re-entrant.  This means
  94. that multiple instances of a resident IFFX can be started from
  95. several CLI's.  Multiple arguments can be given and for CShell
  96. users, the asterisk (*) wild-card can be used to show a complete
  97. directory.
  98.  
  99. What does it not do ?  Color cycling is (intentionally) not
  100. supported.  I left this out because there are plenty of slideshow
  101. programs that do a better job.  Also it would have made the code
  102. considerably larger.  Also, SID (Shareware, Timm Martin) users
  103. can use it as their IFF ILBM picture shower.
  104.  
  105.  
  106. Usage from a CLI window
  107. -----------------------
  108.  
  109. Execute IFFX without any arguments to get the ARP filerequester.
  110. Select the directory and the filename of the picture/anim you
  111. wish to view.  After you close the picture, either select another
  112. one or click on Cancel to quit IFFX.
  113.  
  114. You can also specify one or more arguments.  For example:
  115.  
  116.         1> IFFX :gfx/lo-res/picture1
  117.  
  118. will load the file 'picture1' found in ':gfx/lo-res' and will try
  119. to show it.  Should anything go wrong IFFX will try to give a
  120. meaningful error message.  IFFX will ignore any IFF chunks it
  121. does not recognize and will report this in the CLI.  For example
  122. Deluxe Paint pictures include a 'DPPV' chunk.  IFFX will report
  123. this as follows:
  124.  
  125.         Unknown chunk DPPV.
  126.  
  127. This is not an error and IFFX will continue to show the picture
  128. (unless something else goes wrong).
  129.  
  130. IFFX supports the ARP wild-cards so:
  131.  
  132.         1> IFFX :gfx/lo-res/*
  133.  
  134. will show any picture/anim that is found in the directory
  135. ':gfx/lo-res'.
  136.  
  137.  
  138. Usage from the Workbench
  139. ------------------------
  140.  
  141. 1) Double click the IFFX icon to get the ARP file requester.
  142.  
  143. 2) Shift-select one or more pictures and double click on the IFFX
  144.    icon last to show all the selected pictures.
  145.  
  146. 3) Click on the icon of a picture and select Info from the
  147.    Workbench menu.  Click in the Default Tool string gadget and
  148.    enter the full pathname and filename of IFFX f.i.  C:IFFX.
  149.    Click on "Save".  The Workbench will now change the icon data
  150.    of the picture.  You can now simply double-click on the
  151.    picture icon to show it.
  152.  
  153.  
  154. Features
  155. --------
  156.  
  157. - Close the picture by pressing a key on the keyboard or pressing
  158.   any mouse-button.
  159.  
  160. - The screen can be dragged by an invisible drag bar.  Also in
  161.   the right hand corner are invisible front/back gadget(s).
  162.  
  163. - The mouse pointer will stay visible.
  164.  
  165. - PAL and NTSC pictures are fully supported.  NTSC picture will
  166.   be centered on the screen on PAL Amigas so that there isn't a
  167.   large blank area at the bottom of the screen.  Overscan is
  168.   fully supported.  IFFX will try to center them correctly using
  169.   your current view settings.  HAM and EHB are supported.  EHB is
  170.   default when a 6 bitplane pictures is encountered unless a CAMG
  171.   chunk is found.
  172.  
  173. - Can be used either from the CLI or from the Workbench.
  174.  
  175.  
  176. Error messages
  177. --------------
  178.  
  179. Normally IFFX will try to display a meaningful error message.
  180. There are two exceptions.
  181. IFFX dynamically allocates memory for its variables.  This is
  182. done before anything else, so should there not be enough memory
  183. (452 bytes), IFFX will terminate quietly.
  184. Also, IFFX uses a lot of functions of the arp.library.  This
  185. library should be in the LIBS directory of your boot-disk (LIBS:)
  186. or IFFX will exit quietly.
  187.  
  188. "Not an IFF ILBM file."
  189. You tried to load a file that IFFX does not recognize as an IFF
  190. ILBM file.
  191.  
  192. "Unable to allocate memory for picture".
  193. IFFX tries to load the file completely into memory before showing
  194. it.  This is done for speed reasons.  You have not enough memory
  195. (either FAST or CHIP) to show this file.
  196.  
  197. "Unable to open screen."
  198. IFFX was not able to open an Intuition screen to show the
  199. picture.  This is most likely because you don't have enough chip
  200. memory.
  201.  
  202. "Unable to open window."
  203. IFFX opens an unvisible window on the picture screen.  Something
  204. went wrong while opening the window.
  205.  
  206. "Unable to get necessary chunks."
  207. IFFX needs at least a BMHD, a CMAP and a BODY chunk to display
  208. the picture.  The file you specified is probably a mangled IFF
  209. file.
  210.  
  211. "Unknown compression algorithm."
  212. The picture was crunched using an algorithm that IFFX does not
  213. known.  Currently uncompressed and ByteRun1 compressed pictures
  214. are supported.
  215.  
  216. "DOS error n".
  217. While trying to load the file, AmigaDOS reported an error.
  218. Please refer to a AmigaDOS reference manual for the exact meaning
  219. of the error number.
  220.  
  221.  
  222. Future enhancements
  223. -------------------
  224.  
  225. - Color cycling (?)
  226.  
  227. © 1991 Peter Stuer
  228.                          _
  229.                       _ //
  230.             Thanks to \X/ Amiga for being the best computer ever !
  231.